home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / grabb396.zip / GR4AI.DOC < prev    next >
Text File  |  1992-11-26  |  20KB  |  455 lines
  1.  
  2.  
  3.  
  4.                                      GRABBER(tm)
  5.                            8514/A Adapter Interface Version
  6.                                 Shareware Release 0.50
  7.  
  8.                             -----------------------------
  9.  
  10.                               The Screen Capture Program
  11.                            for MS-DOS and 8514/A-Compatible
  12.                                     Video Graphics
  13.  
  14.  
  15.                           DOCUMENTATION AND TECHNICAL NOTES
  16.                                   November 26, 1992
  17.  
  18.                                Copyright 1991, 1992 by
  19.                                    Gerald A. Monroe
  20.                                  All rights reserved.
  21.  
  22.  
  23.  
  24.  
  25.           YOUR LICENSE TO USE THIS SOFTWARE:
  26.           -----------------------------------
  27.  
  28.           This documentation file and the GR4AI.EXE program are Copyright
  29.           1992 by Gerald A. Monroe.  All rights are reserved except as
  30.           expressly provided here.
  31.  
  32.           These files have been distributed as part of the GRABBER(tm)
  33.           screen capture package, under the terms of a shareware license
  34.           that is fully set forth in the file GRABBER.DOC.  (GRABBER.DOC is
  35.           the reference manual for GRABBER.EXE, which is the main program
  36.           module in the package.)
  37.  
  38.           The shareware license terms on the last page of the GRABBER.DOC
  39.           file are incorporated here by reference.  This license permits
  40.           you to freely copy and distribute this documentation and
  41.           GR4AI.EXE, provided that:  these files are always distributed
  42.           together with each other and with all the other files in the
  43.           GRABBER package; none of the files is modified in any way; and no
  44.           fee, premium or donation of any kind is charged or requested for
  45.           their distribution except as permitted on the terms described in
  46.           the GRABBER.DOC file.
  47.  
  48.           Continued use of any of these programs for more than a 10-day
  49.           trial period requires you to register your use of the software
  50.           with the author.  For more information about the benefits of
  51.           registration and how to go about registering, please refer to the
  52.           full licensing and ordering information in the GRABBER.DOC file.
  53.  
  54.  
  55.  
  56.                                   Table of Contents
  57.  
  58.  
  59.                Shareware License Terms ............................  1
  60.  
  61.                Overview of GR4AI.EXE ..............................  3
  62.  
  63.                About this documentation ...........................  4
  64.  
  65.                Using GRABBER and GR4AI simultaneously .............  4
  66.  
  67.                Modifying the GR4AI hotkey .........................  4
  68.  
  69.                GR4AI's audible error indicators ...................  5
  70.  
  71.                Features not available with GR4AI ..................  5
  72.  
  73.                GR4AI installation options .........................  5
  74.                     DEFAULTDRIVE ..................................  6
  75.                     MOUSE and NOMOUSE .............................  6
  76.                     UNLOAD ........................................  6
  77.                     SOUND and NOSOUND .............................  6
  78.                     PROMPT and NOPROMPT ...........................  7
  79.                     SWAPMODE ......................................  7
  80.  
  81.                "Thanks for trying GRABBER" messages ...............  7
  82.  
  83.                Offspring file compatibility with other systems ....  8
  84.  
  85.                Offspring file command-line options ................  8
  86.  
  87.                Converting GR4AI offspring to PCX and GIF formats ..  9
  88.  
  89.           GR4AI(tm)        Documentation & Technical Notes      Page 3 of 9
  90.  
  91.  
  92.  
  93.  
  94.  
  95.           OVERVIEW OF GR4AI.EXE
  96.           ----------------------
  97.  
  98.           GR4AI(tm) is an alternative version of the GRABBER screen capture
  99.           program.  It is designed exclusively for capturing high-resolu-
  100.           tion 640 x 480 and 1024 x 768 graphic images from PC systems that
  101.           are compatible with the IBM 8514/A Adapter Interface, and which
  102.           are running in "real mode" under MS-DOS.  (GR4AI, like GRAB-
  103.           BER.EXE, does not capture screens from Microsoft Windows or
  104.           Windows applications.)
  105.  
  106.           The Adapter Interface, or "AI," is a programming interface that
  107.           lets application programs work with your high-resolution video
  108.           adapter.  Usually, the AI is loaded as a memory-resident (TSR)
  109.           program in your computer's memory.  When it is present, it allows
  110.           GR4AI to capture certain types of high-resolution graphics.
  111.  
  112.           GR4AI can only capture a screen if the foreground program that is
  113.           generating the image is actually using the AI to do its screen
  114.           work.  Note that this is not always the case.  For example, if
  115.           you have an IBM 8514/A adapter, or another manufacturer's card
  116.           that is compatible with IBM's 8514/A at the register level (such
  117.           as an ATI 8514/Ultra, Graphics Ultra or Graphics Vantage card),
  118.           then it is possible for some application programs to work with
  119.           the screen by writing directly to the adapter's hardware regis-
  120.           ters and ignoring the AI completely.  GR4AI cannot capture any
  121.           screens from such applications, because unless the AI is being
  122.           used for screen output, GR4AI has no way of knowing that the
  123.           adapter is in use at all.
  124.  
  125.           Therefore, if you have an application from which you want to
  126.           capture screens, and the application's installation or setup
  127.           allows you to choose between AI-compatible and 8514/A register-
  128.           level compatible video, then you should choose the AI-compatible
  129.           option.
  130.  
  131.           Whatever kind of video hardware is installed, GR4AI expects to
  132.           find an AI driver resident in memory when you install it, and
  133.           when you ask it to capture a screen.  If an AI driver is not
  134.           present, GR4AI will not capture the screen.  (With the IBM 8514/A
  135.           and the ATI 8514/A-compatibles mentioned above, the AI driver is
  136.           called HDILOAD.EXE.  If you have a different brand of adapter,
  137.           the driver file may be called by a different name.)
  138.  
  139.           Note that you do not have to have an adapter that is register-
  140.           level compatible with the 8514/A in order to use GR4AI.  All you
  141.           need is an adapter that comes supplied with an AI driver, and an
  142.           application program that uses the AI for its screen output.
  143.  
  144.           GR4AI(tm)        Documentation & Technical Notes      Page 4 of 9
  145.  
  146.  
  147.  
  148.  
  149.  
  150.           ABOUT THIS DOCUMENTATION
  151.           -------------------------
  152.  
  153.           GR4AI can be installed in memory and operated in much the same
  154.           way as GRABBER.EXE, and the two programs have a very similar look
  155.           and feel.  For the most part, this documentation for GR4AI covers
  156.           only the aspects of GR4AI which differ from GRABBER.EXE.  To use
  157.           GR4AI effectively, you should read the GRABBER program documenta-
  158.           tion and become familiar with GRABBER's operation.
  159.  
  160.  
  161.  
  162.           USING GRABBER and GR4AI SIMULTANEOUSLY
  163.           ---------------------------------------
  164.  
  165.           GR4AI is designed to be compatible with GRABBER.  Both programs
  166.           can be installed in memory at the same time.
  167.  
  168.           The default "hotkey" sequence for GR4AI is [Ctrl Alt F10].  That
  169.           is, you hold down the [Ctrl] key and the [Alt] key at the same
  170.           time, then press the [F10] key, then release all three keys.
  171.  
  172.  
  173.  
  174.           MODIFYING THE GR4AI HOTKEY
  175.           ---------------------------
  176.  
  177.           GR4AI allows you to modify your hotkey sequence from the default
  178.           [Ctrl Alt F10] to practically any other key sequence you choose. 
  179.           In this respect, GR4AI is exactly like GRABBER.  There is no
  180.           separate documentation here which covers the procedure for
  181.           changing your GR4AI hotkey.  GR4AI